<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//ZH-CN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta http-equiv="imagetoolbar" content="no" />
	<title>Class Valid</title>
	<link href="../resources/API_Help.css" type="text/css" rel="stylesheet" />
</head>

<body>
<!--打印本页-->
<div class="printCurrentPage">
	<img src="../resources/image/print.gif" align="absmiddle" />&nbsp;
	<a href="valid_API.html" target="_blank">打印本页</a>
</div><br/>

<!--标题说明-->
<h1>Class Valid</h1>
<b>定义于文件：</b>&nbsp;&nbsp;valid.js
<div class="description">本类主要针对各种类型数据值的有效性校验进行了一些必要的封装。</div><br/>
<b>基本语法</b>
<div class="syntax">本类属静态类, 可直接调用：Valid.方法名( 参数 );</div>
<b>参数说明</b>
<div class="parameter"><li>无</li></div>
<b>依赖关系</b>
<div class="parameter">
	<a href="core_API.html">core.js</a>
</div><br/>
<a href="#properties">相关属性</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#methods">相关方法</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#events">相关事件</a>&nbsp;&nbsp;-&nbsp;&nbsp;
<a href="#examples">应用示例</a>
<hr>

<!--相关属性-->
<a name="properties"></a>
<h2>相关属性</h2>
<div class="properties">本类无相关属性。</div>

<!--相关方法-->
<a name="methods"></a>
<h2>相关方法</h2>
<table width="100%" cellspacing="0">
	<tbody>
		<tr>
			<td class="tableHead" width="83%">所有方法</td>
			<td class="tableHead" width="17%">所属类</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#checkCID" class="methodLink">Valid.checkCID</a>( <em>value:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验18位身份证编号的有效性。
			</td><td class="tableLineRight">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#checkDate" class="methodLink">Valid.checkDate</a>( <em>value:String</em>,&nbsp;&nbsp;<em>format:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验日期型文本的有效性。
			</td><td class="tableLineRight alt">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#checkEmail" class="methodLink">Valid.checkEmail</a>( <em>value:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验Email信箱的有效性。
			</td><td class="tableLineRight">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#checkMobile" class="methodLink">Valid.checkMobile</a>( <em>value:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验手机号码的有效性。
			</td><td class="tableLineRight alt">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#checkNumber" class="methodLink">Valid.checkNumber</a>( <em>value:String</em>,&nbsp;&nbsp;<em>format:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验整型、浮点型文本的有效性与取值范围。
			</td><td class="tableLineRight">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#checkPC" class="methodLink">Valid.checkPC</a>( <em>value:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验邮政编码的有效性。
			</td><td class="tableLineRight alt">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#checkPhone" class="methodLink">Valid.checkPhone</a>( <em>value:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验电话号码的有效性。
			</td><td class="tableLineRight">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft alt">
				<a href="#checkText" class="methodLink">Valid.checkText</a>( <em>value:String</em>,&nbsp;&nbsp;<em>format:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验自定义文本的有效性。
			</td><td class="tableLineRight alt">Valid</td>
		</tr>
		<tr>
			<td class="tableLineLeft">
				<a href="#checkURL" class="methodLink">Valid.checkURL</a>( <em>value:String</em> )&nbsp;:&nbsp;boolean<br/>
				校验URL的有效性。
			</td><td class="tableLineRight">Valid</td>
		</tr>
	</tbody>
</table>

<!--相关事件-->
<a name="events"></a>
<h2>相关事件</h2>
<div class="properties">本类无相关事件。</div><br/>

<hr>

<!--相关方法的详细说明-->
<h2>本类方法的详细说明</h2>
<div class="detailWrap">

<a name="checkCID"></a>
<div class="mdetail">
	<h3>Valid.checkCID</h3>
	<div class="functionDefine">Valid.checkCID = function( value:String )</div>
	<div class="mdetailDetails">
		校验18位身份证编号的有效性。<br/>
		本方法仅以中国新版身份证的权位系数关系算法验证CID的有效性, 并不能验证CID的真实性。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">CID编号。</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkDate"></a>
<div class="mdetail alt">
	<h3>Valid.checkDate</h3>
	<div class="functionDefine">Valid.checkDate = function( value:String, format:String )</div>
	<div class="mdetailDetails">
		校验日期型文本的有效性。
	</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">日期型文本。</div>
			<li><em>format</em> : String</li>
			<div class="subDesc">日期格式表达式。<br/>
			参数 format 语法：&lt; Y 连接符 M 连接符 D &gt; 或 &lt; M 连接符 D 连接符 Y &gt;<br/>
			&nbsp;&nbsp;大写Y代表4位年份的位置, 大写M代表1-2位月份的位置, 大写D代表1-2位日的位置。<br/>
			&nbsp;&nbsp;连接符: 为自定义的非字母和数字的单个字符。<br/>
			&nbsp;&nbsp;例如: Y-M-D 或 M/D/Y 或 Y-M#D<br/>
			&nbsp;&nbsp;注意: value中的连接符一定要与日期格式表达式中的连接符一一对应。
			</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkEmail"></a>
<div class="mdetail">
	<h3>Valid.checkEmail</h3>
	<div class="functionDefine">Valid.checkEmail = function( value:String )</div>
	<div class="mdetailDetails">校验Email信箱的有效性。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">Email信箱。</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkMobile"></a>
<div class="mdetail alt">
	<h3>Valid.checkMobile</h3>
	<div class="functionDefine">Valid.checkMobile = function( value:String )</div>
	<div class="mdetailDetails">校验手机号码的有效性。<br/>
	校验范围: [ 国家区号 ] [ - ] &lt; 手机号码 &gt;</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">手机号码。</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkNumber"></a>
<div class="mdetail">
	<h3>Valid.checkNumber</h3>
	<div class="functionDefine">Valid.checkNumber = function( value:String, format:String )</div>
	<div class="mdetailDetails">校验整型、浮点型文本的有效性与取值范围。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">整型或浮点型文本。</div>
			<li><em>format</em> : String</li>
			<div class="subDesc">文本格式表达式。<br/>
			参数 format 语法：&lt; Type &gt; [, $ 整数位数 | 小数位数 ] [, # 最小值 | 最大值 ]<br/>
			&nbsp;&nbsp;Type: 代表验证类型, 取值: INTEGER 或 DOUBLE。<br/>
			&nbsp;&nbsp;$符: 为整数位与小数位长度设置符, 配合校验DOUBLE值时使用, 可省略。<br/>
			&nbsp;&nbsp;#符: 为 value 的取值范围设置符, 可省略。<br/><br/>
			&nbsp;&nbsp;<b>文本格式表达式用例:</b>
			<div  class="functionDefine">
				"INTEGER,#10|30"　　　　　　　　　　为10到30之间的整数。<br/>
				"DOUBLE,$3|2,#5.5|150.75"　　　　为5.5到150.75之间且有两位小数的浮点数。
			</div>
			</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkPC"></a>
<div class="mdetail alt">
	<h3>Valid.checkPC</h3>
	<div class="functionDefine">Valid.checkPC = function( value:String )</div>
	<div class="mdetailDetails">校验邮政编码的有效性。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">邮政编码。</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkPhone"></a>
<div class="mdetail">
	<h3>Valid.checkPhone</h3>
	<div class="functionDefine">Valid.checkPhone = function( value:String )</div>
	<div class="mdetailDetails">校验电话号码的有效性。<br/>
	校验范围: [ 国家区号 ] [ - ] [ 区号 ] [ - ] &lt; 电话号码 &gt; [ - 分机号 ]</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">电话号码。</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkText"></a>
<div class="mdetail alt">
	<h3>Valid.checkText</h3>
	<div class="functionDefine">Valid.checkText = function( value:String, format:String )</div>
	<div class="mdetailDetails">校验自定义文本的有效性。</div><br/>
	<div class="mdetailDetails"><b>参数</b>
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">字符串文本。</div>
			<li><em>format</em> : String</li>
			<div class="subDesc">文本格式表达式。<br/>
			参数 format 语法：&lt; [A] [,N] [,L] [,U] [,C] &gt; [, $ 最小长度 | 最大长度 ] [, # 范围字符 ]<br/><br/>
			<b>类型符说明</b>
			<table width="60%" cellspacing="0">
				<tr><td class="tableHead">类型符</td><td class="tableHead">说明</td></tr>
				<tr><td class="tableLineLeft">类型符A</td><td class="tableLineRight">允许文本中有任意字符。</td></tr>
				<tr><td class="tableLineLeft alt">类型符N</td><td class="tableLineRight alt">允许文本中有数字。</td></tr>
				<tr><td class="tableLineLeft">类型符L</td><td class="tableLineRight">允许文本中有小写字母。</td></tr>
				<tr><td class="tableLineLeft alt">类型符U</td><td class="tableLineRight alt">允许文本中有大写字母。</td></tr>
				<tr><td class="tableLineLeft">类型符C</td><td class="tableLineRight">允许文本中有中文汉字。</td></tr>
			</table><br/>
			&nbsp;&nbsp;$符: 为文本长度限制符, 有三种设置: <br/>
			&nbsp;&nbsp;&nbsp;&nbsp;1、$5|12 字符串文本的长度在5-12个字符之间；<br/>
			&nbsp;&nbsp;&nbsp;&nbsp;2、$AM 字符串文本不可为空串；<br/>
			&nbsp;&nbsp;&nbsp;&nbsp;3、$EM 字符串文本可以为空串；<br/><br/>
			&nbsp;&nbsp;#符: 为字符串文本中允许出现的字符。<br/><br/>
			<b>文本格式表达式用例:</b>
			<div  class="functionDefine">
				"N,L,U,$4|16"　　　　　　　　　　由数字、大小写字母组成, 长度在4-16位之间的字符串文本。<br/>
				"L,C,$AM"&nbsp;　　　　　　　　　　　　由小写字母、汉字组成且不能为空的字符串文本。<br/>
				"N,U,$6|18,#ACDHIKWS0123"　　由字符 [ ACDHIKWS0123 ] 任意排列组成, 长度在6-18位之间的字符串文本。<br/>
			</div>
			</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

<a name="checkURL"></a>
<div class="mdetail">
	<h3>Valid.checkURL</h3>
	<div class="functionDefine">Valid.checkURL = function( value:String )</div>
	<div class="mdetailDetails">校验URL的有效性。</div><br/>
	<div class="mdetailDetails">
		<ul>
			<li><em>value</em> : String</li>
			<div class="subDesc">URL链接。</div>
		</ul>
		<b>返回值</b>
		<ul><li>boolean</li></ul>
	</div>
	<div class="footer since">@since JSR2.0&nbsp;&nbsp;&nbsp;&nbsp;<a href="valid_API.html">Return</a></div><br/>
</div>

</div><br/>

<!--应用示例-->
<a name="examples"></a>
<h2>应用示例</h2>
<div class="properties"><a href="valid_API.html">valid_API.html</a></div><br/>

<!--页脚-->
<hr>
<div class="footer">JSR - Copyright &copy; 2007-2008 Jsr JS, LLC<br/>All rights reserved.</div>
</body>
</html>
